home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / bbs / logger.zip / LOGGER.DOC < prev    next >
Text File  |  1994-02-17  |  5KB  |  139 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                                     LOGGER
  13.  
  14.                              For ALL bbs systems!
  15.  
  16.                            Written by Scott Lammers
  17.  
  18.                             Using Turbo-Pascal 6.0
  19.  
  20.                                  Version 1.0A
  21.  
  22.                           Released February 17, 1994
  23.  
  24.                                    OVERVIEW
  25.  
  26.  
  27.     Have you ever tried to figure out what had happened on your bulletin board 
  28. only to find you had to undergo a virtual wild-goose chase looking through 
  29. logs, questionaire answer forms, and whatever else just to find one entry?
  30.  
  31.     I have, and I finally decided I'd had enough.  About an hour later, I 
  32. found myself writing this little document for anybody who wishes to use this 
  33. little program.  It's a quick hack, but I believe if you follow instructions 
  34. here, it should work quite handily.
  35.  
  36.     What Logger is, essentially, is a program that will take any number of 
  37. files you choose(up to 255) and combine them into one large file for your ease 
  38. of review later on.  Depending upon your input, it will then either empty out 
  39. these files or leave them alone afterward.  These files are read in the order 
  40. that you choose and input into the merged log in the same order.
  41.  
  42.                                  INSTALLATION
  43.  
  44.  
  45.     Create a directory and place the files LOGGER.EXE and LOGGER.CFG in this 
  46. directory.  Ad calling commands into whatever batch file you wish to control 
  47. this program, and let it fly.
  48.  
  49.     An example call to Logger is such:
  50.  
  51. CD C:\BBS\LOGS
  52. LOGGER LOGGER.CFG
  53.  
  54.     Line 1) CD C:\BBS\LOGS     --  Moving to the directory logger is in
  55.     Line 2) LOGGER LOGGER.CFG  --  Calling Logger and defining its 
  56.                                    configuration file.
  57.  
  58.  
  59.     An example configuration file is such:
  60.  
  61. c:\bbs\logs\
  62. 3
  63. c:\bbs\work\callers.log
  64. Y
  65. c:\bbs\work\newuser.log
  66. Y
  67. c:\bbs\work\sysop.log
  68. Y
  69.  
  70.     A line by line explanation:
  71.  
  72. 1) c:\bbs\logs\            The complete path to the directory to which the 
  73.                            merged log file will be directed.  The filename 
  74.                            itself will be the date in this format:
  75.                            YYYYMMDD.LOG
  76. 2) 3                       The total number of files to be merged.  MUST be a 
  77.                            minimum of 1 and a maximum of 255.  Logger will not
  78.                            work otherwise.
  79. 3) c:\bbs\work\callers.log The filename, complete path included, of the file
  80.                            to be added to the merged log.  This file MUST
  81.                            exist or Logger will not work.  If you have no data
  82.                            for the file just create an empty file using a text
  83.                            editor.  Logger will maintain this file however you
  84.                            instruct from this point on.
  85. 4) Y                       Empty out this file?  Y tells Logger to empty the 
  86.                            file of data.  N tells it to leave it full.  This
  87.                            MUST be capitalised; Logger is case-sensitive at
  88.                            this point.
  89. 5)   \ Repeats of lines 3 and 4 with different files.  
  90. 6)   /
  91.  
  92.                                  HOW IT WORKS
  93.  
  94.  
  95.     Logger will open the configuration file and read the path of the output 
  96. file.  It will then determine the name of this file and open this file for 
  97. output.
  98.     Logger will then read the number of files you wish to merge and will begin 
  99. opening them in a sequential manner.  As it opens each file it will read it 
  100. and copy its contents to the output file.  It will then read the indicator 
  101. whether or not you wish the input file emptied out and act accordingly.  The 
  102. input file will then be closed.  Logger will then move on to the next file 
  103. listed in the configuration file.
  104.     This process continues until logger reads the indicated number of input 
  105. files.
  106.  
  107.                                   LEGAL STUFF
  108.  
  109.  
  110.  
  111.     Logger is distributed as FREEWARE!  That's right!  FREEWARE!  You can 
  112. copy, use and distribute this package to your heart's content without any fear 
  113. of reprisal whatsoever.
  114.  
  115.     I make only a few requests here:
  116.  
  117. 1>  Any changes or modifications made to this program will result in my being 
  118. notified.
  119.  
  120. 2>  Any bug reports will please be directed to me so a better, more bug-free 
  121. version may come about later.
  122.  
  123. 3>  I am not rich.  There is no registration for this, but I do have limits to 
  124. my time and money - if you find this useful, please send a contribution my 
  125. way.
  126.  
  127.     For contributions, bug reports, and notification of changes and 
  128. modifications, please mail this address:
  129.  
  130.         Scott Lammers
  131.         1633 Raleigh Rd Apt 9
  132.         Lexington, KY 40505
  133.  
  134. PS - The source-code for this program *is* available at the reasonable price 
  135. of $7.50 - if you wish to have a copy, please send this amount in US backed 
  136. funds to the address given above, along with a specification of 5.25 or 3.5 
  137. inch floppy diskettes.
  138.  
  139.